package com.ruoyi.circle.mapper;

import java.math.BigDecimal;
import java.util.List;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.ruoyi.circle.domain.CircleBasicInfo;

/**
 * 圈子基础信息Mapper接口
 * 
 * @author 区嘉盛
 * @date 2025-06-09
 */
public interface CircleBasicInfoMapper extends BaseMapper<CircleBasicInfo> {
    /**
     * 查询圈子基础信息
     * 
     * @param id 圈子基础信息主键
     * @return 圈子基础信息
     */
    public CircleBasicInfo selectCircleBasicInfoById(Long id);

    /**
     * 查询圈子基础信息列表
     * 
     * @param circleBasicInfo 圈子基础信息
     * @return 圈子基础信息集合
     */
    public List<CircleBasicInfo> selectCircleBasicInfoList(CircleBasicInfo circleBasicInfo);

    /**
     * 新增圈子基础信息
     * 
     * @param circleBasicInfo 圈子基础信息
     * @return 结果
     */
    public int insertCircleBasicInfo(CircleBasicInfo circleBasicInfo);

    /**
     * 修改圈子基础信息
     * 
     * @param circleBasicInfo 圈子基础信息
     * @return 结果
     */
    public int updateCircleBasicInfo(CircleBasicInfo circleBasicInfo);

    /**
     * 删除圈子基础信息
     * 
     * @param id 圈子基础信息主键
     * @return 结果
     */
    public int deleteCircleBasicInfoById(Long id);

    /**
     * 批量删除圈子基础信息
     * 
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteCircleBasicInfoByIds(Long[] ids);

    /**
     * 更新圈子成员数量
     *
     * @param circleId 圈子ID
     * @param memberCount 成员数量
     * @return 结果
     */
    public int updateCircleMemberCount(Long circleId, int memberCount);

    /**
     * 更新圈子帖子数量
     *
     * @param circleId 圈子ID
     * @param postCount 帖子数量
     * @return 结果
     */
    public int updateCirclePostCount(Long circleId, int postCount);

    /**
     * 更新圈子热度分数
     *
     * @param circleId 圈子ID
     * @param heatScore 热度分数
     * @return 结果
     */
    public int updateCircleHeatScore(Long circleId, BigDecimal heatScore);
    
    /**
     * 根据标签ID列表查询圈子基础信息列表
     * 
     * @param circleBasicInfo 圈子基础信息
     * @param tagIds 标签ID列表
     * @return 圈子基础信息集合
     */
    public List<CircleBasicInfo> selectCircleBasicInfoListByTags(CircleBasicInfo circleBasicInfo, Long[] tagIds);

    /**
     * 获取热门圈子列表
     *
     * @return 热门圈子列表
     */
    public List<CircleBasicInfo> getHotCircle();

    /**
     * 获取我创建的圈子列表
     *
     * @param createUserId 创建用户ID
     * @return 我创建的圈子列表
     */
    List<CircleBasicInfo> getCircleCreatedByMe(Long createUserId);

    /**
     * 获取我加入的圈子列表
     *
     * @param userId 用户ID
     * @return 我加入的圈子列表
     */
    List<CircleBasicInfo> getJoinedCircle(Long userId);

    /**
     * 获取我待审批的圈子列表
     *
     * @param createUserId 创建用户ID
     * @return 待审批的圈子列表
     */
    List<CircleBasicInfo> getMyApprovalCircle(Long createUserId);

    /**
     * 获取所有圈子列表
     *
     * @return 所有圈子列表
     */
    List<CircleBasicInfo> getAllCircle();

    /**
     * 根据圈子名称查询圈子
     *
     * @param circleName 圈子名称
     * @return 圈子列表
     */
    List<CircleBasicInfo> queryCircleByCircleName(String circleName);

    /**
     * 根据标签ID查询圈子
     *
     * @param tagId 标签ID
     * @return 圈子列表
     */
    List<CircleBasicInfo> getCircleByTagId(Long tagId);
}
